AREANN 3   IE 4   DOM 1

The AREA object reflects the AREA element, which defines the shape, coordinates, and destination of a clickable region of a client-side image map. Navigator and Internet Explorer (for compatibility with Navigator) treat an AREA object as a member of the links collection, since an AREA object behaves much like a link, but for a segment of an image.

 
HTML Equivalent
<AREA>
 
Object Model Reference
NN [window.]document.links[i]
IE [window.]document.links[i]
[window.]document.all.elementID
altNN n/a   IE 4   DOM 1
 Read/Write
 

Future nongraphical browsers may use the alt property setting to display a brief description of the meaning of the (invisible) image's hotspots.

 
Example
document.all.elementID.alt = "To Next Page"
 
Value
Any quoted string of characters.
 
Default None.
coordsNN n/a   IE 4   DOM 1
 Read/Write
 

Defines the outline of the area to be associated with a particular link or scripted action. Coordinate values are entered as a comma-delimited list. If hotspots of two areas should overlap, the area that is defined earlier in the code takes precedence.

 
Example
document.all.mapArea2.coords = "25, 5, 50, 70"
 
Value
Each coordinate is a length value, but the number of coordinates and their order depend on the shape specified by the SHAPE attribute, which may optionally be associated with the element. For SHAPE="rect", there are four coordinates (left, top, right, bottom); for SHAPE="circle" there are three coordinates (center-x, center-y, radius); for SHAPE="poly" there are two coordinate values for each point that defines the shape of the polygon.
 
Default None.
hashNN 2   IE 3   DOM 1
 Read/Write
 

That portion of the HREF attribute's URL following the # symbol, referring to an anchor location in a document. Do not include the # symbol when setting the property.

 
Example
document.all.mapArea2.hash = "section3"
 
Value
String.
 
Default None.
hostNN 2   IE 3   DOM 1
 Read/Write
 

The combination of the hostname and port (if any) of the server of the destination document for the area link. If the port is explicitly part of the URL, the hostname and port are separated by a colon, just as they are in the URL. If the port number is not specified in an HTTP URL for IE 4, it automatically returns the default, port 80.

 
Example
document.all.mapArea2.host = "www.megacorp.com:80"
 
Value
String of hostname optionally followed by a colon and port number.
 
Default Depends on server.
hostnameNN 2   IE 3   DOM 1
 Read/Write
 

The hostname of the server (i.e., a "two-dot" address consisting of server name and domain) of the destination document for the area link. The hostname property does not include the port number.

 
Example
document.links[2].hostname = "www.megacorp.com"
 
Value
String of hostname (server and domain).
 
Default Depends on server.
hrefNN 2   IE 3   DOM 1
 Read/Write
 

The URL specified by the element's HREF attribute.

 
Example
document.links[2].href = "http://www.megacorp.com"
 
Value
String of complete or relative URL.
 
Default None.
noHrefNN n/a   IE 4   DOM 1
 Read/Write
 

Whether the area defined by the coordinates has a link associated with it. When you set this property to true, scriptable browsers no longer treat the element as a link.

 
Example
document.links[4].noHref = "true"
 
Value
Boolean value: true | false.
 
Default false
pathnameNN 2   IE 3   DOM 1
 Read/Write
 

The pathname component of the URL assigned to the element's HREF attribute. This consists of all URL information following the last character of the domain name, including the initial forward slash symbol.

 
Example
document.all.myLink.pathname = "/images/logoHiRes.gif"
 
Value
String.
 
Default None.
portNN 2   IE 3   DOM 1
 Read/Write
 

The port component of the URL assigned to the element's HREF attribute. This consists of all URL information following the colon after the last character of the domain name. The colon is not part of the port property value.

 
Example
document.all.myLink.port = "80"
 
Value
String (a numeric value as string).
 
Default None.
protocolNN 2   IE 3   DOM 1
 Read/Write
 

The protocol component of the URL assigned to the element's HREF attribute. This consists of all URL information up to and including the first colon of a URL. Typical values are: "http:", "file:", "ftp:", "mailto:".

 
Example
document.all.secureLink.protocol = "https"
 
Value
String.
 
Default None.
shapeNN n/a   IE 4   DOM 1
 Read/Write
 

The shape of a server-side image map area whose coordinates are specified with the COORDS attribute.

 
Example
document.all.area51.shape = "circle"
 
Value
Case-insensitive shape constant as string: default | rect | rectangle | circle | poly | polygon
 
Default rect
tabIndexNN n/a   IE 4   DOM 1
 Read/Write
 

A number that indicates the sequence of this element within the tabbing order of all focusable elements in the document. Tabbing order follows a strict set of rules. Elements that have values other than zero assigned to their tabIndex properties are first in line when a user starts tabbing in a page. Focus starts with the element with the lowest tabIndex value and proceeds in order to the highest value, regardless of physical location on the page or in the document. If two elements have the same tabIndex values, the element that comes earlier in the document receives focus first. Next come all elements that either don't support the tabIndex property or have the value set to zero. These elements receive focus in the order in which they appear in the document. A value of -1 removes the element from tabbing order altogether.

Note that the Macintosh user interface does not provide for giving focus to elements other than text and password INPUT fields.

 
Example
document.all.mapArea2.tabIndex = 6
 
Value
Integer.
 
Default None.
targetNN 2   IE 3   DOM 1
 Read/Write
 

The name of the window or frame that is to receive content as the result of navigating to an area link. Such names are assigned to frames by the FRAME element's NAME attribute; for subwindows, the name is assigned via the second parameter of the window.open( ) method. If you are scripting the navigation of another window or frame, use the window or frame name in a statement that assigns a new URL to the location.href property (frameName.location.href = "newURL").

 
Example
document.all.homeArea.target = "_top"
 
Value
String value of the window or frame name, or any of the following constants (as a string): _parent | _self | _top | _blank. The _parent value targets the frameset to which the current document belongs; the _self value targets the current window; the _top value targets the main browser window, thereby eliminating all frames; and the _blank value creates a new window of default size.
 
Default None.
blur( )NN n/a   IE 4   DOM n/a

Removes focus from the current element and fires an onBlur event (in IE). No other element necessarily receives focus as a result.

 
Returned Value
None.
 
Parameters
None.
focus( )NN n/a   IE 4   DOM n/a

Gives focus to the current element and fires the onFocus event (in IE). If another element had focus at the time, it receives an onBlur event.

 
Returned Value
None.
 
Parameters
None.